.. highlightlang:: us

.. _@f{cursor_value}:

@f{cursor_value}
================

.. index:: @f{cursor_value}

.. us.tag  @f{cursor_value} GERMAN fieldfunction New5100

Zeigt den x- oder y-Wert einer 2D-Kurve an der Cursor-Position an.

.. function::  @f{cursor_value(dataset_name)}
    @f{cursor_value(dataset_name, iCursor)}
    @f{cursor_value(dataset_name, iCursor, format)}
    @f{cursor_value(dataset_name, iCursor, format, x_or_y)}

.. us.params

**Parameter**

.. uparam:: dataset_name

   *dataset_name* ist der Name des Datensatzes für den der Cursowert
   angezeigt werden soll.

.. uparam:: iCursor

   *index* ist der Cursor 1 oder 2. Defaultwert ist 1
   Die Nummerierung beginnt mit 1.

.. uparam:: format

   *format* legt das Format der Ausgabe fest. Siehe :ref:`printf`.
   Defaultwert ist %g

.. uparam:: x_or_y

   *x_offset* ist entweder der Wert x oder y. Defaultwert is y.

.. us.comment

**Kommentar**

Die Feldfunktion kann in eine Zelle einer Tabelle oder in ein Textobjekt 
eingefügt werden.

Der Ergebniswert wir bei Verschiebung des Cursors aktualisiert. Wenn der
Cursor nicht mehr angezeigt wird, bleibt der Wert unverändert.

.. us.example

**Beispiel**

.. highlight:: none

::

   @f{cursor_value(Data1, 1, %.3lf)}{9.000}

.. highlight:: us

.. seealso::
   :ref:`uberblick-feldfunktionen`,
   :ref:`bearbeitenfelder-aktualisieren`,
   :ref:`diagrammfeldfunktion-einfugen`,
   :ref:`dateialias-tabelle-bearbeiten`

:sub:`id-728090`